home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / ftn / sphmod.z / sphmod
Encoding:
Text File  |  2002-10-03  |  5.9 KB  |  133 lines
  1.  
  2.  
  3.  
  4. SSSSPPPPHHHHMMMMOOOODDDD((((3333LLLL))))                                                          SSSSPPPPHHHHMMMMOOOODDDD((((3333LLLL))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      sssspppphhhhmmmmoooodddd - set sphere attributes
  10.  
  11. FFFFOOOORRRRTTTTRRRRAAAANNNN 77777777 SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ggggllll////ffffsssspppphhhheeeerrrreeee....hhhh>>>>
  13.  
  14.      iiiinnnntttteeeeggggeeeerrrr****4444 ffffuuuunnnnccccttttiiiioooonnnn sssspppphhhhmmmmoooodddd((((aaaattttttttrrrriiiibbbbuuuutttteeee,,,, vvvvaaaalllluuuueeee))))
  15.      iiiinnnntttteeeeggggeeeerrrr****4444 aaaattttttttrrrriiiibbbbuuuutttteeee
  16.      iiiinnnntttteeeeggggeeeerrrr****4444 vvvvaaaalllluuuueeee
  17.  
  18. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  19.      _a_t_t_r_i_b_u_t_e
  20.             the sphere attribute to set
  21.  
  22.      _v_a_l_u_e  the value to which the attribute is to be set
  23.  
  24. FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  25.      Returns -1 if an invalid attribute or value is specified, 0 otherwise.
  26.  
  27. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  28.      sssspppphhhhmmmmoooodddd is used to specify the attributes of a sphere.
  29.  
  30.      The sphere attributes and valid settings are as follows:
  31.  
  32.      SSSSPPPPHHHHTTTTEEEESSSS
  33.           selects the type of sphere tesselation.  Valid settings for
  34.           tesselation are: SSSSPPPPHHHHOOOOCCCCTTTT, SSSSPPPPHHHHIIIICCCCOOOOSSSS, SSSSPPPPHHHHBBBBAAAARRRR, SSSSPPPPHHHHCCCCUUUUBBBB, and SSSSPPPPHHHHBBBBIIIILLLL. These
  35.           constants correspond to algorithms that tesselate a sphere into
  36.           polygons based on the following types of tesselation:  octahedral,
  37.           icosahedral, barycentric, cubic, and bilinear tesselation.  The
  38.           octahedral, icosahedral, and cubic methods tesselate by subdividing
  39.           the original faces of the base form.  The barycentric method
  40.           guarantees that all of the triangles have equal area and has the
  41.           same number of triangles as the octahedral tesselation.  The
  42.           bilinear tesselation is the traditional longitude-latitude method.
  43.           The default tesselation is SSSSPPPPHHHHOOOOCCCCTTTT.
  44.  
  45.      SSSSPPPPHHHHDDDDEEEEPPPP
  46.           sets depth of sphere tesselation. The number of polygons in a sphere
  47.           is a function of the tesselation type, depth, and primitive used.
  48.           Higher depth values result in more polygons, and hence a smoother
  49.           looking sphere that takes longer to draw.  Valid settings for sphere
  50.           depth are any value from 1 to SSSSPPPPHHHHMMMMXXXXDDDD, inclusive.  The default sphere
  51.           depth is 5.
  52.  
  53.      SSSSPPPPHHHHPPPPRRRRIIII
  54.           selects the GL drawing primitive.  Valid settings for sphere
  55.           primitive are: SSSSPPPPHHHHPPPPOOOOLLLL, SSSSPPPPHHHHMMMMSSSSHHHH, SSSSPPPPHHHHLLLLIIIINNNN, and SSSSPPPPHHHHPPPPNNNNTTTT.  When the
  56.           primitive attribute is set to SSSSPPPPHHHHPPPPOOOOLLLL, independent triangles or quads
  57.           are drawn, depending on the sphere tesselation type.  When using
  58.           SSSSPPPPHHHHMMMMSSSSHHHH, tmeshes or qstrips are used.  The default value for the
  59.           sphere primitive is SSSSPPPPHHHHMMMMSSSSHHHH.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SSSSPPPPHHHHMMMMOOOODDDD((((3333LLLL))))                                                          SSSSPPPPHHHHMMMMOOOODDDD((((3333LLLL))))
  71.  
  72.  
  73.  
  74.      SSSSPPPPHHHHHHHHEEEEMMMM
  75.           toggles the hemisphere attribute.  When TRUE, less than the entire
  76.           sphere may be drawn, but all of the non-negative Z portion of the
  77.           sphere from its canonical orientation will be drawn. Use of this
  78.           attribute can improve performance when using the SSSSPPPPHHHHOOOORRRRIIII attribute.
  79.           The default value is FALSE, meaning that full spheres are drawn.
  80.  
  81.      SSSSPPPPHHHHOOOORRRRIIII
  82.           to toggle the fixed-orientation attribute.  When TRUE, spheres will
  83.           be displayed in a fixed orientation. This means that when viewing
  84.           rotations are done, the center of a sphere is transformed to its
  85.           correct position, and the sphere surface is drawn in a fixed
  86.           orientation. The default orientation is the canonical orientation
  87.           unless specified by user with the sssspppphhhhrrrrmmmmaaaa cmd.  Use of this attribute
  88.           can reduce some lighting artifacts.  When the value of SPH_ORIENT is
  89.           TRUE, the Sphere Library assumes uniform scaling.  When doing non-
  90.           uniform scaling in viewing transformations the results are
  91.           undefined.  The default value is FALSE so that spheres can be
  92.           manipulated freely by all matrix operations.
  93.  
  94. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  95.      libsphere, sphdra, sphfre, sphgnp, sphobj, sphrma
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.